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5. AN INTRODUCTION TO SHELL 
INTRODUCTION 


The shell is a command programming language that provides an interface to the UNIX operating system. 
Its features include control-flow primitives, parameter passing, variables, and string substitution. Constructs 
such as while, if then else, case, and for are available. Two-way communication is possible between the shell 
and commands. String-valued parameters, typically file names or flags, may be passed to a command. A return 
code is set by commands that may be used to determine control-flow, and the standard output from a command 
may be used as shell input. 


The shell can modify the environment in which commands run. Input and output can be redirected to files, 
and processes that communicate through pipes can be invoked. Commands are found by searching directories 
in the file system in a sequence that can be defined by the user. Commands can be read either from the terminal 
or from a file which allows command procedures to be stored for later use. 


The shell is both a command language and a programming language that provides an interface to the UNIX 
operating system. This volume describes, with examples, the UNIX operating system shell. The “Simple Com- 
mands” part of this section covers most of the everyday requirements of terminal users. Some familiarity with 
UNIX operating system is an advantage when reading this section; refer to the section “BASICS for Beginners”. 
The “Shell Procedures” part of this section describes those features of the shell primarily intended for use 
within shell commands or procedures. These include the control-flow primitives and string-valued variables 
provided by the shell. A knowledge of a programming language would be helpful when reading this section. 
The last part, “Keyword Parameters”, describes the more advanced features of the shell. See Table 5.A for a 
defined listing of grammar words used in this section. 


Throughout this section, each reference of the form name(1M), name(7), or name(8) refers to entries in 
the UNIX System Administrator’s Manual. All other references to entries of the form name(N), where “N” 
is a number (1 through 6) possibly followed by a letter, refer to entry name in section N of the UNIX System 
User’s Manual. 


SIMPLE COMMANDS 


Simple commands consist of one or more words separated by blanks. The first word is the name of the com- 
mand to be executed; any remaining words are passed as arguments to the command. For example, 


who 
is a command that prints the names of users logged in. The command 
is'=I 


prints a list of files in the current directory. The argument —/ tells Is(1) to print status information, size, and 
the creation date for each file. 


A. Background Commands 


To execute a command, the shell normally creates a new process and waits for it to finish. A command may 
be run without waiting for it to finish. For example, 


cc pgm.c & 


calls the C compiler to compile the file pgm.c. The trailing “&” is an operator that instructs the shell not to 
wait for the command to finish. To help keep track of such a process, the shell reports its process number fol- 
lowing its creation. A list of currently active processes may be obtained using the ps(1) command. 
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B. Input/Output Redirection 


Most commands produce output to the standard output that is initially connected to the terminal. This out- 
put may be directed to a file by the notation “>” thus: 


Is —1 >file 
The notation >file is interpreted by the shell and is not passed as an argument to Is(1). If file does not. exist, 
the shell creates it; otherwise, the original contents of file are replaced with the output from Is(1). Output may 
be appended to a file using the notation “>>” as follows: 
ls —1 >>file 
In this case, file is also created if it does not already exist. 
The standard input of a command may be taken from a file instead of the terminal by the notation “<” thus: 


we <file 


The command we(1) reads its standard input (in this case redirected from file) and prints the number of charac- 
ters, words, and lines found. If only the number of lines is required, then 


we —| <file 
can be used. 
C. Pipelines and Filters 


The standard output of one command may be connected to the standard input of another by writing the 
“pipe” operator, indicated by !, between commands as in 


Is —1} we 
Two or more commands connected in this way constitute a pipeline, and the overall effect is the same as 
ls —1 >file; we <file 
except that no fileis used. Instead the two processes are connected by a pipe [see pipe(2)] and are run in parallel. 


Pipes are unidirectional, and synchronization is achieved by halting we(1) when there is nothing to read and 
halting Is(1) when the pipe is full. 


A filter is a command that reads its standard input, transforms it in some way, and prints the result as 
output. One such filter, grep(1) selects from its input those lines that contain some specified string. For exam- 
ple, 


Isi grep old 


prints those lines, if any, of the output from Is that contain the string “old”. Another useful filter is sort(1). 
For example, 


who} sort 
will print an alphabetically sorted list of logged in users. 
A pipeline may consist of more than two commands, for example, 


Is! grep old} we —1 
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prints only the number of file names in the current directory containing the string “old”. 
D. File Name Generation 
Many commands accept arguments which are file names. For example, 
Is —] main.e 


prints only information relating to the file main.c. The “Is —1” command alone prints the same information 
about all files in the current directory. 


The shell provides a mechanism for generating a list of file names that match a pattern. For example, 
ls —] *.¢ 


generates as arguments to Is(1) all file names in the current directory that end in .c. The character “*” is a pat- 
tern that will match any string including the null string. In general, patterns are specified as follows: 


= Matches any string of characters including the null string. 
? Matches any single character. 
eet Matches any one of the characters enclosed. A pair of characters separated by a minus will 


match any character lexically between the pair. 
For example, 
[a—z]* 
matches all names in the current directory beginning with one of the letters a through z. The input 
/usr/fred/test/? 


matches all names in the directory /usr/fred/test that consist of a single character. If no file name is found 
that matches the pattern, then the pattern is passed, unchanged, as an argument. 


This mechanism is useful both to save typing and to select names according to some pattern. It may also 
be used to find files. For example, 


echo /usr/fred/*/core 
finds and prints the names of all core files in subdirectories of /usr/fred. |The echo(1) command is a standard 


UNIX operating system command that prints its arguments, separated by blanks.] This last feature can be ex- 
pensive requiring a scan of all subdirectories of /usr/fred. 


“ee 


There is one exception to the general rules given for patterns. The character “.” at the start of a file name 
must be explicitly matched. The input 


echo * 
will therefore echo all file names in the current directory not beginning with “.”. The input 


echo .* 
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which mean “the current directory” and “the parent directory”, respectively. [Notice that 1s(1) suppresses infor- 
mation for the files “.” and “..”.] 


will echo all those file names that begin with “.”. This avoids inadvertent matching of the names “.” and “..” a 
E. Quoting 
Characters that have a special meaning to the shell, such as ee 


Be en ee Ce ee ee 


are called metacharacters. A complete list of metacharacters is given in Table 5.B. Any character preceded by 
a \ is quoted and loses its special meaning, if any. The \ is elided so that 


echo \? & 
will echo a single ?, and 


echo \\ 


will echo a single \. To allow long strings to be continued over more than one line, the sequence \ newline (or 
RETURN) is ignored. The \ is convenient for quoting single characters. When more than one character needs 
quoting, the above mechanism is clumsy and error prone. A string of characters may be quoted by enclosing 
the string between single quotes. For example, 


echo xx’****’xx 


will echo os 


Xx**#¥¥yy 


The quoted string may not contain a single quote but may contain newlines which are preserved. This quoting 
mechanism is the most simple and is recommended for casual use. A third quoting mechanism using double 
quotes is also available and prevents interpretation of some but not all metacharacters. Details of quoting are 
described under “D. Evaluation and Quoting” in part “Keyword Parameters”. 


F, Prompting by the Shell 


When the shell is used from a terminal, it will issue a prompt to the terminal user indicating it is ready 
to read a command from the terminal. By default, this prompt is “$ ”. The prompt may be changed by entering, 


PS1=newprompt & 


that sets the prompt to be the string “newprompt”. If a newline is typed and further input is needed, the shell 
will issue the prompt “> ”. Sometimes this can be caused by mistyping a quote mark. If it is unexpected, then 
an interrupt (DEL) will return the shell to read another command. The other prompt (>) may be changed by 
entering: 


PS2=more 


G._ The Shell and Login &) 


Following the user’s login(1), the shell is called to read and execute commands typed at the terminal. If 
the user’s login directory contains the file .profile, then it is assumed to contain commands and is read immedi- 
ately by the shell before reading any commands from the terminal. 
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H. Summary 


Is 

Print the names of files in the current directory. 
Is >file 

Put the output from Is into file. 

Is i we —1 

Print the number of files in the current directory. 
Is} grep old 

Print those file names containing the string “old”. 
Is! grep old{ we —1 

Print the number of files whose name contains 
the string “old”. 

ce pgm.c & 

Run ce in the background. 


SHELL PROCEDURES 
The shell may be used to read and execute commands contained in a file. For example, the following call 
sh file [ args ... ] 
calls the shell to read commands from file. Such a file call is called a “command procedure” or “shell proce- 
dure”. Arguments may be supplied with the call and are referred to in file using the positional parameters $ 
1, $2, .... For example, if the file wg contains 
whoi grep $1 
then the call 
sh wg fred 
is equivalent to 
who} grep fred 
All UNIX operating system files have three independent attributes (often called “permissions”), read, 
write, and execute (rwx). The UNIX operating system command echmod(1) may be used to make a file execut- 
able. For example, 
chmod +x wg 
will ensure that the file wg has execute status (permission). Following this, the command 
wg fred 
is equivalent to the call 


sh wg fred 


This allows shell procedures and programs to be used interchangeably. In either case, a new process is created 
to execute the command. 


As well as providing names for the positional parameters, the number of positional parameters in the call 
is available as $#. The name of the file being executed is available as $0. 
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A special shell parameter $* is used to substitute for all positional parameters except $0. A typical use 
of this is to provide some default arguments, as in, 


nroff —T450 —cm $* 
which simply prepends some arguments to those already given. 
A. Control Flow—for 
A frequent use of shell procedures is to loop through the arguments ($1, $2, ...) executing commands once 


for each argument. An example of such a procedure is tel that searches the file /usr/lib/telnos that contains 
lines of the form 


fred mh0123 
bert mh0789 
The text of tel is 
for i 
do 
grep $i /usr/lib/telnos; done 
The command 
tel fred 
prints those lines in /usr/lib/telnos that contain the string “fred”. 
The command 
tel fred bert 
prints those lines containing “fred” followed by those for “bert”. 
The for loop notation is recognized by the shell and has the general form 
for name in wl w2 
do 
command-list 
done 
A command-list is a sequence of one or more simple commands separated or terminated by a newline or a 
semicolon. Furthermore, reserved words like do and done are only recognized following a newline or semicolon. 
A name is a shell variable that is set to the words wl w2... in turn each time the command-list following 
do is executed. If “in wl w2...” is omitted, then the loop is executed once for each positional parameter; that 
is, in $* is assumed. 
Another example of the use of the for loop is the create command whose text is 


for 1 do > $i; done 


The command 


create alpha beta 
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ensures that two empty files alpha and beta exist and are empty. The notation >file may be used on its own 
to create or clear the contents of a file. Notice also that a semicolon (or newline) is required before done. 


B. Control Flow—case 
A multiple way (choice) branch is provided for by the case notation. For example, 
case $# in 
1) cat >> $1 5; 
2) cat >>$2 <$1 ;; 
*) echo\* ’usage: append [ from ] to’ ;; 


esac 


is an append command. (Note the use of semicolons to delimit the cases.) When called with one argument as 
in 


append file 
$# is the string “1”, and the standard input is appended (copied) onto the end of file using the cat(1) command. 
append filel file2 


appends the contents of file1 onto file2. If the number of arguments supplied to append is other than 1 or 2, 
then a message is printed indicating proper usage. 


The general form of the case command is 


case word in 
pattern) command-list; 


esac 
The shell attempts to match word with each pattern in the order in which the patterns appear. If a match is 


found, the associated command-list is executed and execution of the case is complete. Since * is the pattern 
that matches any string, it can be used for the default case. 


Caution: No check is made to ensure that only one pattern matches the case argument. 


The first match found defines the set of commands to be executed. In the example below, the commands follow- 
ing the second ‘“*” will never be executed since the first “*” executes everything it receives. 


case $/ in 
of ea 
<j 
esac 


Another example of the use of the case construction is to distinguish between different forms of an argu- 
ment. The following example is a fragment of a ec(1) command. 


for i 


do 
case $i in 
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—[ocs}) ... 3; 
—*) echo ’unknown flag $i’ ;; 
* ¢) /lib/cO $i ... 3; 
*) echo \ ‘unexpected argument $1\*’ ;; 
esac 
done 


To allow the same commands to be associated with more than one pattern, the case command provides for 
alternative patterns separated by a}! . For example, 


case $i in 
=e ay ue 
esac 


is equivalent to 


case $i in 


—[xy]) -.. 
esac 


The usual quoting conventions apply so that 


case $i in 


65 se 


will match the character ?. 


C. Here Documents ee 


The shell procedure tel described under “A. Control Flow—for” in this section uses the file /usr/lib/telnos 
to supply the data for grep(1). An alternative is to include this data within the shell procedure as a here docu- 
ment, as in, 


for i 
do 
grep $i <<! 


fred mh0123 
bert mh0789 


! 
done 


In this example, the shell takes the lines between <<! and ! as the standard input for grep(1). The string “!” 
is arbitrary. The document is being terminated by a line that consists of the string following <<. 


Parameters are substituted in the document before it is made available to grep(1) as illustrated by the fol- 
lowing procedure called edg. 


ed $3 <<% 
2/$1/s//$2/g 
w 

% 


The call 
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edg string] string? file 

is then equivalent to the command 
ed file <<% 
g/string1/s//string2/g 
w 


% 


and changes all occurrences of “string1” in file to “string2”. Substitution can be prevented using \ to quote the 
special character $ as in 


ed $3 <<+ 

1,\$s/$1/$2/g 

w 

= 
[This version of edgis equivalent to the first except that ed(1) will print a ? if there are no occurrences of the 
string $1.] Substitution within a here document may be prevented entirely by quoting the terminating string, 
for example, 

grep $i <<\# 

t 


The document is presented without modification to grep. If parameter substitution is not required in a here 
document, this latter form is more efficient. 


D. Shell Variables 


The shell provides string-valued variables. Variable names begin with a letter and consist of letters, digits, 
and underscores. Variables may be given values by writing 


user=fred box=m000 acct=mh0000 
which assigns values to the variables user, box, and acct. A variable may be set to the null string by entering 
null= 
The value of a variable is substituted by preceding its name with $; for example, 
echo $user 
will echo fred. 
Variables may be used interactively to provide abbreviations for frequently used strings. For example, 


b=/usr/fred/bin 
mv file $b 


will move the file from the current directory to the directory /usr/fred/bin. A more general notation is available 
for parameter (or variable) substitution, as in, 


echo ${user} 
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which is equivalent to 
echo $user 
and is used when the parameter name is followed by a letter or digit. For example, 


tmp=/tmp/ps 
ps a >${tmp}a 


will direct the output of ps(1) to the file /tmp/psa, whereas, 
ps a >$tmpa 
would cause the value of the variable tmpa to be substituted. 
Except for $?, the following are set initially by the shell. 
$? The exit status (return code) of the last command executed as a decimal 
string. Most commands return a zero exit status if they complete success- 
fully; otherwise, a nonzero exit status is returned. Testing the value of re- 


turn codes is dealt with later under if and while commands. 


$# The number of positional parameters in decimal. Used, for example, in the 
append command to check the number of parameters. 


$$ The process number of this shell (in decimal). Since process numbers are 
unique among all existing processes, this string is frequently used to gen- 
erate unique temporary file names. For example, 
ps a >/tmp/ps$$ 
rm /tmp/ps$$ 
$! The process number of the last process run in the background (in decimal). 
$— The current shell flags, such as —x and —v. 
Some variables have a special meaning to the shell and should be avoided for general use. 
$ MAIL When used interactively, the shell looks at the file specified by this 
variable before it issues a prompt. If the specified file has been modi- 
fied since it was last looked at, the shell prints the message “you have 
mail” before prompting for the next command. This variable is typi- 
cally set in the file .profile in the user’s login directory. For example: 
MAIL=/usr/mail/fred 
$HOME The default argument for the ed(1) command. The current directory 
is used to resolve file name references that do not begin with a / and 
is changed using the ed command. For example, 


ed /usr/fred/bin 


makes the current directory /usr/fred/bin. Then 


cat wn 


Page 64 


6/82 


$ PATH 


$PS1 
$PS2 
$1FS 


& E. Test Command 


ISSUE 1 USER’S GUIDE 


will print on the terminal the file wnin this directory. The command ed(1) with no argu- 
ment is equivalent to 


ed $HOME 
This variable is also typically set in the user’s login profile. 


A list of directories containing commands (the search path). Each time a command is 
executed by the shell, a list of directories is searched for an executable file. If $PATH 
is not set, the current directory, /bin, and /usr/bin are searched by default. Otherwise, 
$PATH consists of directory names separated by :. For example, 


PATH=:/usr/fred/bin:/bin:/usr/bin 


specifies that the current directory (the null string before the first :), /usr/fred/bin, 
/bin, and /usr/bin are to be searched in that order. In this way, individual users can 
have their own “private” commands that are accessible independently of the current 
directory. If the command name contains a /, this directory search is not used; a single 
attempt is made to execute the command. 


The primary shell prompt string, by default, “$ ”. 
The shell prompt when further input is needed, by default, “> ”. 


The set of characters used by blank interpretation (See “D. Evaluation and Quoting” 
in part “Keyword Parameters”.). 


The test command is intended for use by shell programs. For example, 


test —f file 


returns zero exit status if file exists and nonzero exit status otherwise. In general, test evaluates a predicate 
and returns the result as its exit status. Some of the more frequently used test arguments are given below 
[| see test(1) for a complete specification]. 


test s 
test —f file 
test —r file 


test —w file 
test —d file 


F. Control Flow—while 


true if the argument sis not the null string 
true if file exists 

true if file is readable 

true if file is writable 

true if file is a directory 


The actions of the for loop and the case branch are determined by data available to the shell. A while 
or until loop and an if then else branch are also provided whose actions are determined by the exit status re- 
turned by commands. A while loop has the general form 


while command-listl 
vi do 


command-list2 


done 
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The value tested by the while command is the exit status of the last simple command following while. Each 
time round the loop, command-list1 is executed; if a zero exit status is returned, then command-list2is executed; 
otherwise, the loop terminates. For example, 


while test $1 


7 Se 
shift ; 


done 


is equivalent to 


done 
The shift command is a shell command that renames the positional parameters $2, $3, ... as $1, $2, ... and ce 
loses $1. 


Another kind of use for the while/until loop is to wait until some external event occurs and then run some 
commands. In an until loop, the termination condition is reversed. For example, 


until test —f file 


do 

sleep 300 
done 
commands 


will loop until file exists. Each time round the loop, it waits for 5 minutes (300 seconds) before trying again. SS) 
(Presumably, another process will eventually create the file.) 


G. Control Flow—if 
Also available is a general conditional branch of the form, 


if command-list 
then 
command-list 
else 
command-list 
fi 


that tests the value returned by the last simple command following if. & 


The if command may be used in conjunction with the test command to test for the existence of a file as 
in 


if test —f file 
then 
process file 
else 
do something else 


; & 


An example of the use of if, case, and for constructions is given in “I, The Man Command” in part “Shell 
Procedures”. 
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A multiple test if command of the form 


1 oes 
then 
else 
t.. 
then 
else 
ths. 
fi 
fi 
fi 


may be written using an extension of the if notation as, 


3 aeee 
then 


elif ... 
then 


elif ... 
fi 


The touch command changes the “last modified” time for a list of files. The command may be used in con- 
junction with make(1) to force recompilation of a list of files. The following example is the touch command: 


flag= 
for i 
do 
case $i in 
—c) flag=N ;; 
*) if test —f $i 
then 
In $i junk$$ 
rm junk$$ 
elif test $flag 
then 
echo file \‘$i\’ does not exist 
else 
> $i 
nS 
esac 
done 


The —e flag is used in this command to force subsequent files to be created if they do not already exist. Other- 
wise, if the file does not exist, an error message is printed. The shell variable flagis set to some non-null string 
if the —e argument is encountered. The commands 


In’... TRe::. 
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make a link to the file and then remove it. The sequence 
if commandl 
then 
command2 
fi 
may be written 
command! && command2 
Conversely, 


command] !! command2 


executes command2 only if command] fails. In each case, the value returned is that of the last simple com- 
mand executed. 


Command Grouping 
Commands may be grouped in two ways, 
{ command-list ; } 
and 
( command-list ) 


The first form, command-list is simply executed. The second form executes command-list as a separate pro- 
cess. For example, 


(ed x; rm junk ) 
executes rm junk in the directory x without changing the current directory of the invoking shell. 
The commands 
ed x; rm junk 
have the same effect but leave the invoking shell in the directory x. 
H. Debugging Shell Procedures 


The shell provides two tracing mechanisms to help when debugging shell procedures. The first is invoked 
within the procedure as 


set —v 


(v for verbose) and causes lines of the procedure to be printed as they are read. It is useful to help isolate syntax 
errors. It may be invoked without modifying the procedure by entering 


sh —v proc ... 
where proc is the name of the shell procedure. This flag may be used in conjunction with the —n flag which 


prevents execution of subsequent commands. (Note that typing “set —n” at a terminal will render the terminal 
useless until an end-of-file is typed.) 
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The command 
set —x 


will produce an execution trace with flag —x. Following parameter substitution, each command is printed as 
it is executed. (Try the above at the terminal to see the effect it has.) Both flags may be turned off by typing 


set — 
and the current setting of the shell flags is available as $—. 


1. The “man” Command 


The following is the man command which is used to print sections of the UNIX System User’s Manual. It 
is called by entering 


man sh 
man —t ed 
man 2 fork 


In the first call, the manual section for sh is printed. Since no section is specified, section 1 is used. The second 
call will typeset (—t option) the manual section for ed. The last call prints the fork manual page from section 
2 of the manual. 


A version of the man command follows: 
ed /usr/man 


: colon is the comment command’ 
: default is nroff ($N), section 1 ($s)’ 


N=n s=l1 
for i 
do 
case $i in 
[1-9]*) s=$i ;; 
si} a haa S 
bh): Neen; 
—*) — echo unknown flag \’$i\ ;; 
*) if test —f man$s/$i.$s 
then 
${N}roff man0/${N jaa man$s/$i.$s 
else 
: ‘look through all manual sections’ 
found=no 
forj}in123456789 
do 
if test —f man$j/$i.$j 
then man $j $i 
found=yes 
fi 
done 
case $found in 
no) echo ’$i: manual page not found’ 
esac 
us 
esac 
done 
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KEYWORD PARAMETERS 

Shell variables may be given values by assignment or when a shell procedure is invoked. An argument to 
a shell procedure of the form name=value that precedes the command name causes value to be assigned to name 
before execution of the procedure begins. The value of namein the invoking shell is not affected. For example, 

user=fred command 

will execute command with user set to fred. The —k flag causes arguments of the form name=value to be inter- 
preted in this way anywhere in the argument list. Such names are sometimes called keyword parameters. If 
any arguments remain, they are available as positional parameters $1, $2, ... . 

The set command may also be used to set positional parameters from within a procedure. For example, 


Set" 


will set $1 to the first file name in the current directory, $2 to the next, etc. Note that the first argument, —, 
ensures correct treatment when the first file name begins with a —. 


A. Parameter Transmission 

When a shell procedure is invoked, both positional and keyword parameters may be supplied with the call. 
Keyword parameters are also made available implicitly to a shell procedure by specifying in advance that such 
parameters are to be exported. For example, 

export user box 

marks the variables user and box for export. When a shell procedure is invoked, copies are made of all export- 
able variables for use within the invoked procedure. Modification of such variables within the procedure does 
not affect the values in the invoking shell. It is generally true of a shell procedure that it may not modify the 
state of its caller without explicit request on the part of the caller. (Shared file descriptors are an exception 
to this rule.) 


Names whose value is intended to remain constant may be declared readonly. The form of this command 
is the same as that of the export command, 


readonly name ... 
Subsequent attempts to set readonly variables are illegal. 
B. Parameter Substitution 


If a shell parameter is not set, then the null string is substituted for it. For example, if the variable dis 
not set, 


echo $d 
or 
echo ${d } 


will echo nothing. A default string may be given as in 


echo ${d—.} 
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which will echo the value of the variable dif it is set and “.” otherwise. The default string is evaluated using 
the usual quoting conventions so that 


echo ${d— **’} 
will echo * if the variable d is not set. Similarly, 
echo ${d—$1} 


will echo the value of dif it is set and the value (if any) of $1 otherwise. A variable may be assigned a default 
value using the notation 


echo ${d=.} 
which substitutes the same string as 
echo ${d—.} 


and if d were not previously set, it will be set to the string “.”. (The notation ${...=...} is not available for posi- 
tional parameters.) 


If there is no sensible default, the notation 
echo ${d?message } 
will echo the value of the variable dif it has one; otherwise, message is printed by the shell and execution of 
the shell procedure is abandoned. If message is absent, a standard message is printed. A shell procedure that 
requires some parameters to be set might start as follows: 
: ${user?} ${acct?} ${bin? } 
Colon (:) is a command built in to the shell and does nothing once its arguments have been evaluated. If any 
of the variables user, acct, or bin are not set, the shell will abandon execution of the procedure. 
C. Command Substitution 
The standard output from a command can be substituted in a similar way to parameters. The command 
pwd(1) prints on its standard output the name of the current directory. For example, if the current directory 
is /usr/fred/bin., the command 
d=’pwd’ 
is equivalent to 
d=/usr/fred/bin 
The entire string between grave accents (‘...') is taken as the command to be executed and is replaced with 
the output from the command. The command is written using the usual quoting conventions except that a ‘ must 


be escaped using a \. For example, 


Is ‘echo "$1" 
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is equivalent to 

Is $1 
Command substitution occurs in all contexts where parameter substitution occurs (including here documents), 
and the treatment of the resulting text is the same in both cases. This mechanism allows string processing com- 
mands to be used within shell procedures. An example of such a command is basename which removes a speci- 
fied suffix from a string. For example, 

basename main.c .c 
will print the string “main”. Its use is illustrated by the following fragment from a ee(1) command. 

case $A in 

‘a B=‘basename $A .c‘ 

esac. 

that sets B to the part of $A with the suffix .c stripped. 
Here are some composite examples. 
e for iin ‘Is -t’ do... 
The variable jis set to the names of files in time order, most recent first. 
e set ‘date; echo $6 $2 $3, $4 
will print, e.g., 1977 Nov 1, 23:59:59 
D. Evaluation and Quoting 
The shell is a macro processor that provides parameter substitution, command substitution, and file name 

generation for the arguments to commands. This section discusses the order in which these evaluations occur 


and the effects of the various quoting mechanisms. 


Commands are parsed initially according to the grammar given in Table 5.A. Before a command is executed, 
the following substitutions occur: 


1. parameter substitution, e.g., $user 
2. command substitution, e.g., ‘pwd*‘ 
Only one evaluation occurs so that if, for example, the value of the variable X is the string “$y” then 
echo $X 
will echo “$y”. 
3. blank interpretation 


Following the above substitutions, the resulting characters are broken into nonblank words (blank 
interpretation). For this purpose, ‘blanks’ are the characters of the string “$/F'S”. By default, this string 
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consists of blank, tab, and newline. The null string is not regarded as a word unless it is quoted. For exam- 
ple, 


echo’’ 
will pass on the null string as the first argument to echo, whereas 
echo $null 
will call echo with no arguments if the variable null is not set or set to the null string. 


4. file name generation Each word is then scanned for the file pattern characters *, ?, and [...]; and an alpha- 
betical list of file names is generated to replace the word. Each such file name is a separate argument. 


The evaluations just described also occur in the list of words associated with a for loop. Only substitution 
occurs in the word used for a case branch. 


As well as the quoting mechanisms described earlier using \ and ’...’, a third quoting mechanism is provided 
using double quotes. Within double quotes, parameter and command substitution occurs; but file name genera- 
tion and the interpretation of blanks does not. The following characters have a special meaning within double 
quotes and may be quoted using \. 

$ parameter substitution 

‘command substitution 

" ends the quoted string 

\ quotes the special characters $‘" \ 
For example, 


echo "$x" 


will pass the value of the variable x as a single argument to echo. Similarly, 


echo "$*" 


will pass the positional parameters as a single argument and is equivalent to 
echo "$1 $2..." 

The notation $@ is the same as $* except when it is quoted. Inputting 
echo "$@" 

will pass the positional parameters, unevaluated, to echo and is equivalent to 
eche "Si" "$2" =. 


The following illustration gives, for each quoting mechanism, the shell metacharacters that are evaluated. 
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metacharacter 


t = terminator 
y = interpreted 
n = not interpreted 


In cases where more than one evaluation of a string is required, the built-in command eval may be used. 
For example, if the variable X has the value “$y” and if y has the value “pqr”, then 


eval echo $X 
will echo the string “pqr”. 


In general, the eval command evaluates its arguments (as do all commands) and treats the result as input 
to the shell. The input is read and the resulting command(s) executed. For example, 


wg='eval who} grep’ 
$weg fred 


is equivalent to 
who} grep fred 


In this example, eval is required since there is no interpretation of metacharacters, such as|, following substi- 
tution. 


E. Error Handling 
The treatment of errors detected by the shell depends on the type of error and on whether the shell is being 


used interactively. An interactive shell is one whose input and output are connected to a terminal [as deter- 
mined by gtty(2)]. A shell invoked with the —i flag is also interactive. 


Execution of a command (see also “G. Command Execution”) may fail for any of the following reasons: 
e Input/output redirection may fail. For example, if a file does not exist or cannot be created. 
e The command itself does not exist or cannot be executed. 
e The command terminates abnormally, for example, with a “bus error” or “memory fault” signal. 
e The command terminates normally but returns a nonzero exit status. 
In all of these cases, the shell will go on to execute the next command. Except for the last case, an error 


message will be printed by the shell. All remaining errors cause the shell to exit from a command procedure. 
An interactive shell will return to read another command from the terminal. Such errors include the following: 


e Syntax errors, e.g., if ...then... done 
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then either exits or returns to the terminal 


€ e A signal such as interrupt. The shell waits for the current command, if any, to finish execution and 


e Failure of any of the built-in commands such as ed(1). 


Ca The shell flag —e causes the shell to terminate if any error is detected. The following is a list of the UNIX 
operating system signals: 
1 hangup 
2 interrupt 
os quit 
& 4* illegal instruction 
a trace trap 
ig IOT instruction 
i fe EMT instruction 
8* floating point exception 
9 Kill (cannot be caught or ignored) 
€ 10* bus error 
t1* segmentation violation 
12* bad argument to system call 
13 write on a pipe with no one to read it 
14 alarm clock 
15 software termination [from kill(1)] 


The UNIX operating system signals marked with an asterisk “*” as shown in the list produce a core dump 


The signals in this list of potential interest to shell programs are 1, 2, 3, 14, and 15. 


&) if not caught. However, the shell itself ignores quit which is the only external signal that can cause a dump. 


F. Fault Handling 


Shell procedures normally terminate when an interrupt is received from the terminal. The trap command 
is used if some cleaning up is required, such as removing temporary files. For example, 


trap ’rm /tmp/ps$$; exit’ 2 


& sets a trap for signal 2 (terminal interrupt); and if this signal is received, it will execute the following commands: 


rm /tmp/ps$$; exit 
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The exit is another built-in command that terminates execution of a shell procedure. The exit is required; oth- 
er-wise, after the trap has been taken, the shell will resume executing the procedure at the place where it was 
interrupted. 


UNIX operating system signals can be handled in one of three ways. 

1. They can be ignored, in which case the signal is never sent to the process. 

2. They can be caught, in which case the process must decide what action to take when the signal is received. 
3. They can be left to cause termination of the process without it having to take any further action. 


If a signal is being ignored on entry to the shell procedure, for example, by invoking it in the background (see 
“G. Command Execution”), trap commands (and the signal) are ignored. 


The use of trap is illustrated by this modified version of the touch command illustrated below: 


flag= 
trap ’rm —f junk$$; exit? 12315 
for i 
do 
case $i in 
—c) flag=N ;; 
*) if test —f $1 
then 
In $i junk$$; rm junk$$ 
elif test $flag 
then 
echo file \’$i\’ does not exist 
else 
> $i 
i; 
esac 
done 


The cleanup action is to remove the file junk$$. The trap command appears before the creation of the tem- 
porary file; otherwise, it would be possible for the process to die without removing the file. 


Since there is no signal 0 in the UNIX operating system, it is used by the shell to indicate the commands 
to be executed on exit from the shell procedure. 


A procedure may, itself, elect to ignore signals by specifying the null string as the argument to trap. The 
following: 


fraps 2S 1s 


ig a fragment taken from the nohup(1) command which causes the UNIX operating system HANGUP, INTER- 
RUPT, QUIT, and SOFTWARE TERMINATION signals to be ignored both by the procedure and by invoked 
commands, 


Traps may be reset by entering 
trap 23 


which resets the traps for signals 2 and 3 to their default values. A list of the current values of traps may be 
obtained by writing 


trap 
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The scan procedure is an example of the use of trap where there is no exit in the trap command. The scan 
takes each directory in the current directory, prompts with its name, and then executes commands typed at the 
terminal until an end of file or-an interrupt is received. Interrupts are ignored while executing the requested 
commands but cause termination when scan is waiting for input. The sean procedure follows: 


if test —d $d/$i 
then ed $d/$i 
while echo " $i:" 
trap exit 2 
read x 
do trap : 2; eval $x; done 
fi 
done 


The read x is a built-in command that reads one line from the standard input and places the result in the 
variable x. It returns a nonzero exit status if either an end-of-file is read or an interrupt is received. 


G. Command Execution 


To run a command (other than a built-in), the shell first creates a new process using the system call 
fork(2). The execution environment for the command includes input, output, and the states of signals and is 
established in the child process before the command is executed. The built-in command exec is used in rare 
cases when no fork is required and simply replaces the shell with a new command. For example, a simple ver- 
sion of the nohup command looks like 


trap’’12315 
exec $* 


The trap turns off the signals specified so that they are ignored by subsequently created commands, and exec 
replaces the shell by the command specified. 


Most forms of input/output redirection have already been described. In the following, word is only subject 
to parameter and command substitution. No file name generation or blank interpretation takes place so that, 
for example, 


echo ... >*.¢ 


will write its output into a file whose name is *c. Input/output specifications are evaluated left to right as they 
appear in the command. Some input/output specifications are as follows: 


> word The standard output (file descriptor 1) is sent to the file word which is created if it does 
not already exist. 


>> word The standard output is sent to file word. If the file exists, then output is appended (by seek- 
ing to the end); otherwise, the file is created. 

< word The standard input (file descriptor 0) is taken from the file word. 

<< word The standard input is taken from the lines of shell input that follow up to but not includ- 


ing a line consisting only of word. If word is quoted,no interpretation of thedocument occurs. 
If word is not quoted, parameter and command substitution occur and \ is used to 
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quote the characters \, $, ‘, and the first character of word. In the latter case, \newline 
is ignored (e.g., quoted.strings). 


>& digit The file descriptor digit is duplicated using the system call dup(2), and the result is used 


as the standard output. 
<& digit The standard input is duplicated from file descriptor digit. 
<&— The standard input is closed. 
> &— The standard output is closed. 


Any of the above may be preceded by a digit in which case the file descriptor created is that specified by 
the digit instead of the default 0 or 1. For example, 


.. 2>file 
runs a command with message output (file descriptor 2) directed to file. Another example, 
.. 2>G1 


runs a command with its standard output and message output merged. (Strictly speaking, file descriptor 2 is 
created by duplicating file descriptor 1; but the effect is usually to merge the two streams.) 


The environment for a command run in the background such as 
list *.¢ tlpr & 
is modified in two ways. First, the default standard input for such a command is the empty file /dev/null. This 
prevents two processes (the shell and the command), which are running in parallel, from trying to read the 
same input. Chaos would ensue if this were not the case. For example, 
ed file & 


would allow both the editor and the shell to read from the same input at the same time. 


The other modification to the environment of a background command is to turn off the QUIT and INTER- 
RUPT signals so that they are ignored by the command. This allows these signals to be used at the terminal 
without causing background commands to terminate. For this reason, the UNIX operating system convention 
for a signal is that if it is set to 1 (ignored) then it is never changed even for a short time. Note that the shell 
command trap has no effect for an ignored signal. 


H. Invoking the Shell 


The following flags are interpreted by the shell when it is invoked. If the first character of argument zero 
is a minus, commands are read from the file .profile. 


—e string If the —e flag is present, then commands are read from string: 


—s If the —s flag is present or if no arguments remain, commands are read from the standard 
input. Shell output is written to file descriptor 2. 


=] If the ~i flag is present or if the shell input and output are attached to a terminal [as told 
by getty(8)], this shell is interactive. In this case, TERMINATE is ignored (so that kill 
0 does not kill an interactive shell, and INTERRUPT is caught and ignored (so that wait 
is interruptible). In all cases, QUIT is ignored by the shell. 
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item: 


simple-command: 


command: 


pipeline: 


andor: 


command-list: 


input-output: 


file: 


case-part: 


pattern: 


else-part: 


empty: 
word: 
name: 


digit: 
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TABLE 5.A 
GRAMMAR 


word 
input-output 
name = value 


item 
simple-command item 


simple-command 

( command-list ) 

{ command-list } 

for name do command-list done 

for name in word... do command-list done 
while command-list do command-list done 
until command-list do command-list done 
case word in case-part ... esac 

if command-list then command-list else-part fi 


command 
pipeline | command 


pipeline 
andor && pipeline 
andor!! pipeline 


andor 

command-list ; 
command-list & 
command-list ; andor 
command-list & andor 


> file 
< file 
> file 
>> word 
<< word 


word 
& digit 
& a 


pattern) command-list ;; 


word 
pattern | word 


elif command-list then command-list else-part 
else command-list 
empty 


a sequence of nonblank characters 
a sequence of letters, digits, or underscores starting with a letter 


0123456789 
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(a) 


(b) 


(c) 


(d) 


syntactic: 
H 


&& 


>> 


patterns: 


* 


Focal 


substitution: 


$f... } 


‘ ‘ 


quoting: 


reserved words: 


if then else elif fi 

case in esac 

for while until do done 
{ }[] test 
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TABLE 5.B 


METACHARACTERS AND RESERVED WORDS 


pipe symbol 

‘andf’ symbol 

‘orf’? symbol 

command separator 

case delimiter 

background commands 
command grouping 

input redirection 

input from a here document 
output creation 


output append 


match any character(s) including none 
match any single character 


match any of the enclosed characters 


substitute shell variable 


substitute command output 


quote the next character 


quote the enclosed characters except for ’ 


quote the enclosed characters except for the $, ‘,\, and " 
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